---
title: Hook - Media Player
description: This Hook blueprint allows to build a controller-based automation to control a media player. Supports volume setting, play/pause and track selection.
---

import {
  Input,
  Inputs,
  Requirement,
  ImportCard,
  Changelog,
} from '/src/components/blueprints_docs'

<ImportCard id='media_player' category='hooks' />

<br />

:::tip
This blueprint is part of the **Controllers-Hooks Ecosystem**. You can read more about this topic [here](/docs/controllers-hooks-ecosystem).
:::

## Description

This Hook blueprint allows to build a controller-based automation to control a media player. Supports volume setting, play/pause and track selection.
:::info
An automation created with this blueprint must be linked to a [Controller](/docs/blueprints/controllers) automation. Controllers are blueprints which allow to easily integrate a wide range of controllers and use them to run a set of actions when interacting with them. They expose an abstract interface used by Hooks to create controller-based automations.

See the list of [Controllers supported by this Hook](#supported-controllers) for additional details.
:::

## Requirements

<Requirement id='controller' required/>
<Requirement name='Media Player Integration' required>

This integration provides the entity which represents a media player in Home Assistant. It should be activated by default so unless you tweaked the default configuration you're good to go.

[Media Player Integration Docs](https://www.home-assistant.io/integrations/media_player/)

</Requirement>

## Inputs

<Inputs category='hooks' id='media_player' />

## Supported Controllers

- [Aqara WXKG11LM Wireless Mini Switch](/docs/blueprints/controllers/xiaomi_wxkg11lm)
- [IKEA E1524/E1810 TRÅDFRI Wireless 5-Button Remote](/docs/blueprints/controllers/ikea_e1524_e1810)
- [IKEA E1743 TRÅDFRI On/Off Switch & Dimmer](/docs/blueprints/controllers/ikea_e1743)
- [IKEA E1744 SYMFONISK Rotary Remote](/docs/blueprints/controllers/ikea_e1744)
- [IKEA E1766 TRÅDFRI Open/Close Remote](/docs/blueprints/controllers/ikea_e1766)
- [IKEA E1812 TRÅDFRI Shortcut button](/docs/blueprints/controllers/ikea_e1812)
- [IKEA E2001/E2002 STYRBAR Remote control](/docs/blueprints/controllers/ikea_e2001_e2002)
- [IKEA E2123 SYMFONISK sound remote, gen 2](/docs/blueprints/controllers/ikea_e2123)
- [IKEA E2201 RODRET Dimmer](/docs/blueprints/controllers/ikea_e2201)
- [IKEA E2213 SOMRIG shortcut button](/docs/blueprints/controllers/ikea_e2213)
- [IKEA ICTC-G-1 TRÅDFRI wireless dimmer](/docs/blueprints/controllers/ikea_ictc_g_1)
- [OSRAM AC025XX00NJ SMART+ Switch Mini](/docs/blueprints/controllers/osram_ac025xx00nj)
- [Philips 324131092621 Hue Dimmer switch](/docs/blueprints/controllers/philips_324131092621)
- [Philips 8718699693985 Hue Smart Button](/docs/blueprints/controllers/philips_8718699693985)
- [Philips 929002398602 Hue Dimmer switch v2](/docs/blueprints/controllers/philips_929002398602)
- [SONOFF SNZB-01 Wireless Switch](/docs/blueprints/controllers/sonoff_snzb01)
- [Tuya ERS-10TZBVK-AA Smart knob](/docs/blueprints/controllers/tuya_ERS-10TZBVK-AA)
- [Xiaomi WXCJKG11LM Aqara Opple 2 button remote](/docs/blueprints/controllers/xiaomi_wxcjkg11lm)
- [Xiaomi WXCJKG12LM Aqara Opple 4 button remote](/docs/blueprints/controllers/xiaomi_wxcjkg12lm)
- [Xiaomi WXCJKG13LM Aqara Opple 6 button remote](/docs/blueprints/controllers/xiaomi_wxcjkg13lm)
- [Xiaomi WXKG01LM Mi Wireless Switch](/docs/blueprints/controllers/xiaomi_wxkg11lm)

## Additional Notes

Not all media players support the customization of the number of steps for volume control, due to the fact that some of them do not expose their current volume level to Home Assistant. In these situations, the automation will fallback to the `media_player.volume_up` and `media_player.volume_down` services.

## Changelog

<Changelog category='hooks' id='media_player' />
